Faxcover is normally invoked by the sendfax(1) program to generate the cover page for each outgoing facsmile.
Faxcover works by creating a PostScript dictionary that contains definitions for the variable information that is to be placed on the facsimile cover page. Specifically, a dictionary with the following symbols are defined:
Symbol Description Symbol Description to destination person from sending person to-company destination company from-company sender's company to-location destination geographic location from-location sender geographic location to-voice-number person's voice phone number from-voice-number sender's voice phone number to-fax-number destination fax phone number from-fax-number sender's fax phone number regarding Re: subject commentsX X'th line of comments page-count # pages other than cover page todays-date current date and time pageWidth page width in millimeters pageLength page length in millimeters
If the comments string is longer than 35 characters, it is broken, on word boundaries, into multiple PostScript strings. Each line is defined as commentsX where X is the line number; e.g. comments2 for the second line of comments.
If information is unavailable for an item, the associated symbol is defined to be a null string.
Following the definition prologue, a cover sheet template file is copied. This file is expected to be a PostScript program that uses the supplied definitions to generate a cover page. The template must include a showpage operator to cause the page to be imaged. The above definitions will be defined in the current dictionary. A trailing end operator is supplied by faxcover, so any manipulation of the dictionary stack should leave the current dictionary on the top of the stack on completion.
The default template file is named faxcover.ps; this can be overridden with the -C option by specifying a file in the FAXCOVER environment variable. If the file name is not an absolute path, then faxcover looks first for this file in the home directory of the sender. If no such file is present, then it looks in the library directory where the FlexFAX client application data are installed. If no template file is located, faxcover will terminate without generating a cover page.